<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Async Activation</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="up" href="architecture.html" title="Bonobo Activation Architecture">
<link rel="prev" href="server-arch.html" title="Server architecture">
<link rel="next" href="query-langage.html" title="Bonobo Activation Query Langage">
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="server-arch.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="architecture.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
<td><a accesskey="n" href="query-langage.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="sect1">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="async-activation"></a>Async Activation</h2></div></div></div>
<p>
Bonobo Activation also has a set of asynchronous activation interfaces so that you do not need to block
on activation calls. The CORBA level is pretty simple: the activation context has a set of 
<code class="function">_async</code> calls: <code class="function">OAF_ACtivationContext_activate_async</code>
and <code class="function">OAF_ACtivationContext_activate_from_id_async</code>. Both of those calls
take an OAFActivationCallback CORBA object as parameter. This object, which is supposed to 
be implemented by client applications (it is actually implemented in liboaf) will receive
CORBA calls when the activation is finished:
</p>
<pre class="programlisting">
module OAF {
        interface ActivationCallback {
                oneway void report_activation_failed (in string reason);
                oneway void report_activation_succeeded (in ActivationResult result);
        };
};
</pre>
<p>
</p>
<p>
Of course, libbonobo-activation provides comvenient wrappers for those CORBA functions. Those are named
<code class="function">bonobo_activation_activate_async</code> and 
<code class="function">bonobo_activation_activate_from_id_async</code>.
</p>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15.1</div>
</body>
</html>